home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / MorphOS / Epic4_mos / share / epic / help / 6_functions / twiddle < prev    next >
Encoding:
Text File  |  2002-10-28  |  902 b   |  27 lines
  1. Synopsis:
  2.    $twiddle(<tilde-expansion>)
  3.  
  4. Technical:
  5.    This function is used to do tilde-expansion on the given name.  The tilde
  6.    is required.  If a user exists on the system with a home directory, the
  7.    full path of that directory is returned.  If the user does not exist,
  8.    nothing is returned.  If a tilde is not the first character, the input is
  9.    returned.
  10.  
  11. Practical:
  12.    This is useful for ensuring that files will be written to your home
  13.    directory, regardless of the current directory.
  14.  
  15. Returns:
  16.    full path of home directory if user exists, nothing if not, input if error
  17.  
  18. Examples:
  19.    $twiddle(~)                  returns your home directory
  20.    $twiddle(~jvs)               returns home directory for user jvs
  21.    $twiddle(~nosuchuser)        no such user, returns nothing
  22.    $twiddle(blah)               bad input, returns "blah"
  23.  
  24. See Also:
  25.    Environment(7); cd(4)
  26.  
  27.